home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / share / doc / libxml-simple-perl / README < prev   
Text File  |  2006-10-30  |  2KB  |  77 lines
  1. DESCRIPTION
  2.  
  3.   XML::Simple - Easy API to read/write XML (esp config files)
  4.  
  5.  
  6. PREREQUISITES
  7.  
  8.   XML::Simple requires a module capable of parsing XML - either XML::SAX or
  9.   XML::Parser must be installed (if you're running ActivePerl, you'll
  10.   already have XML::Parser installed).
  11.  
  12.   If you have installed XML::SAX, it will be used by default.  You should
  13.   consider installing XML::SAX::Expat or XML::LibXML to replace the (slower)
  14.   PurePerl parser from the XML::SAX distribution.
  15.  
  16.   If you install using the CPAN.pm shell and you do not have either XML::Parser
  17.   or XML::SAX installed, then XML::SAX will be installed by default.
  18.  
  19.   To generate documents with namespaces, XML::NamespaceSupport is required.
  20.  
  21.   The optional caching features of XML::Simple also require Storable.pm.
  22.  
  23.  
  24. WARNING MESSAGES FROM XML::SAX
  25.  
  26.   When you use XML::Simple, you may see this warning message:
  27.  
  28.     could not find ParserDetails.ini in C:/Perl/site/lib/XML/SAX
  29.  
  30.   This means your XML::SAX installation is broken (perhaps you installed
  31.   version 0.10 from the ActiveState PPM repository).  Since it's broken 
  32.   anyway, the simplest way to suppress these warnings is to remove
  33.   C:/Perl/site/lib/XML/SAX.pm.
  34.  
  35.   The procedure for correctly installing the latest version of XML::SAX
  36.   is documented here:
  37.  
  38.     http://perl-xml.sourceforge.net/faq/#win32_cpan
  39.  
  40. BUILDING/INSTALLING
  41.  
  42.   Once the archive is unpacked, use these commands:
  43.  
  44.       perl Makefile.PL
  45.       make
  46.       make test
  47.       make install
  48.  
  49.   If for some reason, you can't run these commands, you can simple copy 
  50.   the Simple.pm file to your lib/XML directory (where Parser.pm lives).
  51.  
  52.   If you want to test the module, but don't have 'make', try:
  53.  
  54.       perl maketest
  55.  
  56.  
  57. STATUS
  58.  
  59.   This version (2.16) is the current stable release.
  60.  
  61.   Please send any feedback to the author: grantm@cpan.org
  62.  
  63.   See 'Changes' for a detailed history.
  64.  
  65.   See 'perldoc XML::Simple' for full documentation.
  66.  
  67.   See 'perldoc XML::Simple::FAQ' for frequently asked questions.
  68.  
  69.  
  70. COPYRIGHT
  71.  
  72.   Copyright 1999-2004 Grant McLean <grantm@cpan.org>
  73.  
  74.   This library is free software; you can redistribute it
  75.   and/or modify it under the same terms as Perl itself.
  76.  
  77.